List Policies

Route

/v2/policies

Description

Retrieve a list of policies based on the provided filters. Policies define enforcement actions for data protection and content inspection.

Method

GET

Inputs

Parameter	Type	Required	Description
filters.ids[]	array[string]	No	List of policy IDs to filter by
filters.include_disabled	boolean	No	Whether to include disabled policies in the results
filters.types[]	array[string]	No	List of policy types to filter by (data_protection, content_inspection)

Output

Field	Type	Description
type	string	Always "policies"
size	integer	Number of policies returned
resources	array[Policy]	Array of policy objects
errors	array[Error]	Any errors encountered

Policy Object Structure

Field	Type	Description
id	string	Unique policy identifier
type	string	Policy type (data_protection, content_inspection)
name	string	Human-readable name
description	string	Detailed description
severity	string	Severity level (informational, low, medium, high, critical)
disabled	boolean	Whether the policy is disabled
selection_type	string	How datasets are selected (dataset, sensitivity)
dataset_ids	array[string]	Specific dataset IDs (when selection_type is dataset)
dataset_sensitivities	array[integer]	Sensitivity levels (when selection_type is sensitivity)
created_at	string	Creation timestamp (ISO 8601)

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response

{
  "type": "policies",
  "size": 2,
  "resources": [
    {
      "id": "policy-123",
      "type": "data_protection",
      "name": "Customer PII Protection",
      "description": "Protect customer personal information",
      "severity": "high",
      "disabled": false,
      "selection_type": "dataset",
      "dataset_ids": ["dataset-456"],
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "policy-789",
      "type": "content_inspection",
      "name": "Financial Data Inspection",
      "description": "Inspect financial content for compliance",
      "severity": "critical",
      "disabled": false,
      "selection_type": "sensitivity",
      "dataset_sensitivities": [4, 5],
      "created_at": "2024-01-10T14:20:00Z"
    }
  ],
  "errors": []
}